home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / SEE.ZIP / SEE.DOC next >
Encoding:
Text File  |  1987-10-09  |  10.3 KB  |  190 lines
  1.  
  2.  
  3.  
  4.           SEE Version 1.7                                   October 9, 1987
  5.  
  6.                                    COPYRIGHT 1987
  7.                                          by
  8.                                ABACUS Computer Service
  9.                                  Donald J. Jackowski
  10.                                     16 Green Road
  11.                                 Mine Hill, NJ  07801
  12.                                    (201) 584-8201
  13.                                  All Rights Reserved
  14.  
  15.           INTRODUCTION
  16.  
  17.                SEE is  a utility  program that  allows a  user to display a
  18.           file containing  non-printable  characters  and  to  make limited
  19.           modifications  to  the  input  to  create  a  file that most text
  20.           editors can handle.  An  option  is  provided  to  strip (Ignore)
  21.           printer control  sequences, making it easy to create a pure ASCII
  22.           file from one containing printer control characters.
  23.  
  24.                Non-printable characters are divided into two classes, those
  25.           in  the  numeric  range  0  through  31  are  considered  CONTROL
  26.           characters except for the four characters that normally  occur in
  27.           text files  namely the  "newline" character (10, ^J, \n, NL), the
  28.           "return" character (13, ^M, \r, CR), the "tab"  character (9, ^I,
  29.           \t,  TAB)  and  the  "formfeed"  character (12, ^L, \f, FF).  The
  30.           second class called GRAPHIC  characters is  comprised of  all the
  31.           characters  in  the  numeric  range  127  through 255.  Some text
  32.           editing programs will not operate correctly on a  file containing
  33.           either class  of non-printable  characters and many programs take
  34.           the control character 26 (^Z) to be an End Of  File marker.   SEE
  35.           offers  a  mechanism  to  allow  the user to visually observe the
  36.           characters contained in  ANY  file  and  then  make  some limited
  37.           substitutions that  will render the output acceptable to any text
  38.           editor.
  39.  
  40.           USAGE
  41.  
  42.                The SEE program usage is:
  43.                     SEE [-aipstNwNiho] file ...
  44.                Where:
  45.                     -a  = show ALL characters.
  46.                     -i  = Ignore ALL non-printing characters.
  47.                     -p  = Ignore ALL Printer control sequences.
  48.                     -s  = Substitute a 'space' for each control character.
  49.                     -ss = Substitute a 'space' for each non-printing char.
  50.                     -tN = Set Tab Stop value. (default 8)
  51.                     -wN = Set output column Width. (default 78)
  52.                     -h  = Show Hex values.
  53.                     -o  = Show Octal values.
  54.  
  55.                When SEE is invoked with no arguments or  if invalid options
  56.           are given,  a short  menu is displayed.  When SEE is invoked with
  57.           one or more file names but no options  the contents  of each file
  58.           is displayed,  all normally non-printing characters are displayed
  59.           as a series of regular printing  characters.   CONTROL characters
  60.           are  displayed  in  the  ^A  style  and  GRAPHIC  characters  are
  61.           displayed as a three digit number surrounded by  the <> character
  62.           pair.
  63.  
  64.  
  65.  
  66.  
  67.           Copyright 1987 (C) by ABACUS Computer Service         Page 1 of 3
  68.  
  69.  
  70.  
  71.           SEE Version 1.7                                   October 9, 1987
  72.  
  73.           OPERATION
  74.  
  75.                The  control  characters  "new  line",  "return", "tab", and
  76.           "form feed" are displayed  as  normal  characters  unless  the -a
  77.           option is  given in  which case they are displayed as ^J, ^M, ^I,
  78.           and ^L.  When the -a option is  given the  length of  each output
  79.           line is  a result of the default column Width setting unless this
  80.           default is changed with the -w option. 
  81.  
  82.                The -s option can be  used  to  cause  SEE  to  substitute a
  83.           'space'  character  (decimal  32)  for  each  occurrence of a any
  84.           control character, if used in conjunction with the  -a option the
  85.           substitution includes  the "new line", "return", "tab", and "form
  86.           feed" characters.  If the -ss option is given a 'space' character
  87.           is  substituted  for  each  GRAPHIC  character"  as  well as each
  88.           CONTROL character."
  89.  
  90.                The  -i  option  will   ignore  both   CONTROL  and  GRAPHIC
  91.           characters and will override and disable the -s option.
  92.  
  93.                The  -p  option  will  ignore  printer control sequences and
  94.           automatically turns on the -i option.  This  option uses  a table
  95.           to determine  the number of bytes to ignore after an ESC (decimal
  96.           27) character.  The default table  contains the  data appropriate
  97.           for an  EPSON FX-85  printer but can be easily modified for other
  98.           printers as outlined under OTHER PRINTERS.
  99.  
  100.                The SEE output (normally displayed  on  the  screen)  can be
  101.           redirected to a file.  For example the command line:
  102.                     SEE file >temp
  103.           Will place the output in the file named TEMP.
  104.  
  105.                Since  SEE  does  not  actually  display  on  the screen but
  106.           depends on the DOS to do  the actual  display the  -t option will
  107.           NOT  affect  the  actual  display.   The -t option is intended to
  108.           provide  tab  setting  control  when  SEE   calculates  how  many
  109.           characters to  permit on  a line, and is generally only needed in
  110.           conjunction with the -w option.  SEE expects  both the  -t and -w
  111.           options to  be given with a number, the first digit of the number
  112.           may be given  immediately  after  the  option  letter  or  may be
  113.           separated from  the option  letter by a 'space', thus the command
  114.           lines:
  115.                     SEE -w45 file       and
  116.                     SEE -w 45 file
  117.           Are equivalent, both set the column width to 45.
  118.  
  119.           NOTE
  120.  
  121.                An interesting use of SEE is to look for message  strings in
  122.           normally unprintable  executable files (i.e .EXE and .COM files).
  123.           For example the command line:
  124.                     SEE -i SEE.EXE
  125.           Will display some random characters, some  of the  actual machine
  126.           codes, and all of the internal messages.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.           Copyright 1987 (C) by ABACUS Computer Service         Page 2 of 3
  135.  
  136.  
  137.  
  138.           SEE Version 1.7                                   October 9, 1987
  139.  
  140.           USER LICENSE
  141.  
  142.                If you  find this program useful you are requested to send a
  143.           $10 registration and  license  fee  to  ABACUS  Computer Service.
  144.           This  fee  will  entitle  you  to  continue that use with a clear
  145.           conscience.  Please pass a copy to a friend!  It is NOT necessary
  146.           to be a licensed user to distribute copies.  All registered users
  147.           will receive notice of the first update that is made  after their
  148.           registration. 
  149.  
  150.           OTHER PRINTERS
  151.  
  152.                The following information is intended as an aid to those who
  153.           use a printer  requiring  different  control  sequences  than the
  154.           EPSON  FX-85.    All  the  ESCAPE  sequence  byte length data are
  155.           maintained in a single  table to  make modification  easier, this
  156.           internal table,  used by  the -p  option, contains  the number of
  157.           bytes to be taken as part of an ESCAPE (27) sequence is:
  158.                /*          0    1    2    3    4    5    6    7    8    9*/
  159.                /* -------------------------------------------------------*/
  160.                /*  00 */   0,   0,   0,   0,   0,   0,   0,   0,   0,   0,
  161.                /*  10 */   0,   0,   0,   0,   1,   1,   0,   0,   0,   0,
  162.                /*  20 */   0,   0,   0,   0,   0,   2,   0,   0,   0,   0,
  163.                /*  30 */   0,   0,   2,   2,   0,   1,   3,   2,   0,   0,
  164.                /*  40 */   0,   0,   0,   0,   0,   2,   0,   2,   1,   1,
  165.                /*  50 */   1,   2,   1,   1,   1,   1,   1,   1,   0,   0,
  166.                /*  60 */   1,   1,   1,   0,   1,   2,   9,   2,   9,   1,
  167.                /*  70 */   1,   1,   1,   2,   2,   0,   0,   1,   2,   1,
  168.                /*  80 */   1,   2,   2,   2,   1,   2,   0,   2,   0,   0,
  169.                /*  90 */   0,   0,   3,   0,   0,   0,   0,   2,   9,   0,
  170.                /* 100 */   0,   0,   0,   0,   0,   2,   2,   0,   2,   0,
  171.                /* 110 */   0,   0,   2,   0,   0,   2,   0,   0,   0,   0,
  172.                /* 120 */   2,   0,   0,   0,   0,   0,   0,   0
  173.  
  174.                This table contains an entry for  each of  the 128 character
  175.           values that  could be  the byte  immediately following the ESCAPE
  176.           byte.  This table begins at 2A42H in the SEE.EXE file.   The zero
  177.           values in  this table represent "Unexpected ESCAPE sequences", an
  178.           error message is displayed if any  such ESCAPE  sequence is found
  179.           in the input.  The values 1 through 8 represent the length of the
  180.           ESCAPE sequence, excluding the ESC character.   EXAMPLE:  row 50,
  181.           column 1  represents 51  which is  the decimal value of the ASCII
  182.           character '3' and the printer ESCAPE sequence:
  183.                     27   51   (n)
  184.                The  length  of  this  ESCAPE  sequence,  excluding  the ESC
  185.           character is two.
  186.  
  187.                The value  9 is interpreted to mean that the next NULL input
  188.           byte marks the end of the  ESCAPE  sequence.    EXAMPLE:  row 60,
  189.           column 8  represents 68  which is  the decimal value of the ASCII
  190.           character 'D' and the printer ESCAPE sequence:
  191.                     27   68   (n1) (n2) ...  0 (NULL)
  192.                The length of this sequence is  signaled by  the terminating
  193.           NULL (zero) byte.
  194.  
  195.  
  196.                If you alter this table to accommodate a different printer I
  197.           would appreciate if you  would send  a copy  of your  table along
  198.           with the  printer make  and model  to: ABACUS  Computer Service. 
  199.           Future versions of SEE will include the data we receive  on other
  200.           printers, and/or an "install" program.
  201.  
  202.           Copyright 1987 (C) by ABACUS Computer Service         Page 3 of 3
  203.